• OPERATING INSTRUCTION {read at least this chapter}
• SYSTEM & MEMORY REQUIREMENT
• SEVERAL THINGS HAPPEN
• EDITING AND VIEWING THE CLIPBOARDS
• THE MENU SUPPORT
• APPLE MENU
• CLIP X
• EDIT
• SWAP
• FKEYS
• FKEYS PROVIDED WITH COPYPASTE
• EVENTTYPE
• ABOUT THE AUTHOR
• KNOWN BUGS AND FEATURES {not my bugs hopefully}
• HISTORY & NEWS
INTRODUCTION
CopyPaste is a German product and it's written in Pascal if you but believe it. People usually say "if you wanna do it in C its easy, but Pascal…"
In this place I would like to thank the people of Mac Software Design specially my brother. They helped me with lots of programming tips, books, source examples and hardware.
CopyPaste 2.5 allows you to use up to 9 independent numbered clipboards by just typing a number between 1 and 9 during the process of cut copy or paste by keyboard before you release the command key. You can equally reach the 9 clipboards by sub-menus in the edit menu of any application.
CopyPaste is provided 'as is' and no guarantee is given in any aspects of its documented and not documented features that could do any harm to you, to your family, to your town, to your country, to the world or to your Macintosh.
SHAREWARE FEE
If you want to get rid of the message at boot time, just register. Send 15$ US or 20 DM to get the key (a hidden password) to remove the shareware message. Please include your exact Address (and a fax number if possible) and the version-number 2.5 of CopyPaste
When I posted this program the first time, I didn't expect many people to pay the fee. Since then several Japanese people and some others have paid the fee an so I was encouraged to improve this piece of software (Thanks to all registered users)
Because mailing a floppy is rather expensive, I have to ask for this amount of money, although some users say it is cheep.
Registered users get the password-key which also enables them to remove the message in future versions. Some locked features are enabled as well. This also means their registration is valid for all future versions. In the past I could include features suggested by registered users and I will try my very best to continue this support if you have a special wish or a nice idea. Now play fair!
first play then pay
$$ Please send cash $$
Comments and bug reports are most welcome even if you are not registered. Write to
Peter Hoerster
Besselweg 243
48149 Münster
Germany
Fax: +49-251-9801663
e-mail hoerste@uni-muenster.de
You may give this program to all your friends but you have to include this readme. If you want to put it on any public server or on any CDROM, you are free to do so, and I am particularly happy if you send me a message where you have posted it.
OPERATING INSTRUCTION
Drop CopyPaste on the systemfolder and reboot.
• Keyboard use: You have to use the keyboard equivalent for cut copy or paste and before you release the command-key you can type an additional number between 1 and 9 to use the appropriate numbered clipboard.
• Edit window: Equally as long as the command-key is down but after typing 'c' or 'v' or 'x' you can click the mouse to encounter a window with menubar which allows you to view the clipboard contents and work on them.
• Multi-Paste: If you type more than one number (up to 9) while pasting, you will build up a paste sequence and the numbered clipboards are pasted in the desired order. Repeating the 'v' before releasing the command key will clear this sequence.
• Menu-Support: CopyPaste now fully supports the standard edit-menu with three sub-menus. The paste-sub-menu shows the kind of scrap or in the case of a text-scrap it shows 15 characters of its content as a quick reminder.
• Tag and Drop: is the poor mans drag and drop. It works as follows: select (tag, highlight) anything in any program, press the ctrl key and click the mouse at a different position. The highlighted portion will be copied and pasted at the mouse-position. Try it, its really smart. With the shift-key simultanously down you will replace the target which you clicked on. (In fact, a double-click is simulated at the target position befor pasting). With the option-key simultanously down you can cut the selected portion, but if the document changes its elements at the position of your mouse-click, you'll get strange results. As a tip for using cut and drop in text: click the mouse behind a return and not inside of a sentence and it will work or click above the previously selected portion . Clicking without a tagged object but with ctrl key down, will just insert the last used clipboard. You may want to deactivate this function in programs like HyperCard or Ragtime where the ctrl-key or command-mouse-click is used. See the preferences section in this readme
• Application Switcher
You can use the command- tabulator-key combination to switch between running applications in the same way the Windows users can do. Just keep the command key pressed and switch through the running applications with the tabulator key. typing the key 'i' in the ApplicationSwitcher displayes process information.
SYSTEM & MEMORY REQUIREMENT
CopyPaste needs System 7! This is because of the expandable systemheap. For small scraps it also works with System 6. It should run on any Mac. (developed on SE 30, tested on LC I Quadra, IIci, Classic, Powerbook, Power PC) It only patches two traps which results in almost no speed-reduction and almost no interference with other Inits.
The registered version eats less then 10k of your expensive memory.
The 'try and buy' version provided with this package takes a little more ram because the notification at boot time also needs to be stored in the systemheap. I could work around this waste of memory, but if you are so interested, you would pay either don't you think so?
CopyPaste itself is extremely fast, as it uses no disk activity to store the clipboards, rather it uses the systemheap to store them in relocatable blocks. Alas this takes ram. But consider 9 clipboards each with the content of a normal page of text, this will take about 30k of memory only. On the other hand 9 pictures with 500k each take about 4,5 megs. If you don't have much money for ram, you should not copy the extensive scraps to a numbered clipboard. The normal clipboard is usually private to the application and if it changes to the desk it will be written to the disk under low memory condition. For your (and my) convenience it is possible to free the memory of all numbered clipboards at one blow. You find the option 'Kill Clips' in the Clip Edit Menu. This command resets all memory blocks to zero and sets the current clipboard to the default one.
YOU WILL NOTICE SEVERAL THINGS HAPPENING.
1. Usually the Menu will flash immediately after you invoked the menu-key (i.e. command key & 'c', 'v', 'x'). With CopyPaste installed the menu will flash not sooner the command-key has been released. This delay happens of course to give you the chance to type the desired clipboard number or to click the mouse.
2. Usually the result of the insert or the cut function appears immediately after typing the key-combination, with CopyPaste installed, you find the results after releasing the command key for the same reason discussed above.
3. If you copy something to the clipboard without any additional number (this is the usual way), the above mentioned points are the only difference you can see. But if you type an additional number you will see the scrollbars blinking when all keys are released. This happens to humbug the current application to give its clipboard contents free and to exchange it with CopyPaste. If you insert the clipboard, its fortunately not necessary to fool the application and you see no blinking. The blinking of the scrollbars likewise influences the current application to redraw its window content. The necessary time for the redraw differs extremely. In the Finder, in Teachtext, in THINKPascal, in ResEdit and in MS Word its almost in the twinkling of an eye (by the way, Word 5.1 brought no problems in the development process and I like it; specially the drag and drop feature). In WordPerfect, Canvas and I think in some other programs with slow graphics you will find a certain delay. This delay of course only happens if you copy to different clipboards or if you first use a numbered clipboard and then use the normal clipboard. The normal clipping without any additional number brings no delay disadvantage.
THE MENU SUPPORT
Since version 2.3 the standard menus are supported, that means you can choose any of the clipboards from the edit-menu by the help of three sub-menus. The Cut, Copy and Paste items have a sub-menu which shows the content of the 9 clipboards. If it contains text, it shows the first 30 characters. If it contains a PICT, a SOUND or a MOVIE it shows the word •Picture• or •SOUND• or •MOVIE•. If it contains any other scrap, it shows the word •Unknown•. So you can quickly see the contents. The last item in any of the submenu (Edit Clipboards) lets you invoke the edit-window.
EDITING AND VIEWING THE CLIPBOARDS
For the more powerful clipboard handling an edit feature is added. The window with the edit menus is invoked by clicking the mouse after you typed the cut copy or paste command sequence but before you release the command key.
You have to keep the command key pressed to use the window and it vanishes after you release the key. If you use the window by selecting the menupoint Edit Clipboards, it stays and you have to use the closebox. The view and edit window will display PICT or TEXT or play SOUND.
Another way to view the clipboard is to select the ShowClipboard menu-point in the Finder and to paste any numbered clipboard.
Here is a short description of the menus in the edit window.
APPLE MENU
The first menu under the apple contains the usual things like the about playground, online help and shareware notice. Another menupoint is the preferences command. Here you can configure some of CopyPastes features:
-Tag and Drop is the poor mans drag and drop and if its active, it works as follows: select (tag, highlight) anything in any program, press the ctrl key and click the mouse at a different position. The highlighted portion will be copied and pasted at the mouse-position. You may want to deactivate this function in programs like HyperCard, Quark, Ragtime or THINK-C editor where the ctrl+mouse is used different. Perhaps it suffices to configure Tag and Drop with ctrl+cmd+mouse in those programs.
-MenuSupport toggles the sub-menu-support of CopyPaste. Perhaps you don't like the sub-menus, although you can see 30 characters of a text-scrap in the paste-sub-menu. This is a quick reminder. You can configure it with two options: The Bill_Gates_Modus forces sub-menus in Microsoft-products like Word 5.1 although the items are not highlighted correctly. This is not my bug! (Please your guys at Microsoft rewrite your MDEF to support sub-menus as WordPerfect does) It also forces sub-menus in other applications that do not use the standard Menudefproc like WordPerfect, Canvas etc. currently this modus requires an English or a German program. Send money and I'll send you a Spanish Menu-support. Nevertheless in standard-menus everything is fine with or without the Bill_Gates_Modus. If the compatibility mode is checked, you'll find the sub-menus in those programs mentioned above under the Apple directly under the about-item of the program as sub-menus of a CopyPaste item.
CLIP X (X IN [0..9])
The second menu under 'Clip x' let you change the active numbered clipboard in which all editing takes place. The window content currently displays either PICT or TEXT scraps or payes sound of the chosen numbered clipboard. You can choose the displayed clipboard by typing the appropriate number. (don't release the command key!)
EDIT
The third menu under 'Clip Edit' allows some basic actions:
• Short-Date inserts the short form of the current date.
• Long-Date inserts the long form of the current date.
• Uppercase converts the text in the current clipboard to uppercase.
• Lowercase converts the text in the current clipboard to lowercase.
• Capitals converts the first character of each word in the text in the current clipboard to its capital.
• Kill Clips resets all memory-blocks to zero and sets the current clipboard to the default one.
• Save TEXT or PICT lets you store a clipboard to a diskfile (only text or pictures).
• Open TEXT or PICT loads text or pictures into the clipboard.
SWAP
This menu lets you exchange the content of the currently displayed clipboard with any of the other clipboards selectable from this menu.
FKEYS
The menu 'FKeys' allows some more sophisticated features of CopyPaste. Any FKey installed directly into CopyPaste is listed under this menupoint and it will be invoked if you select it with the mouse. You can insert your own clipboard manipulating FKeys with ResEdit and extend the functionality by this.
FKEYS PROVIDED WITH COPYPASTE
- Bahá'í-Date converts the date copied to the clipboard into the date form of the Bahá'í-Religion. If no valid date is found in the clipboard, it inserts the Bahá'í date of the day. Bahá'í-Date detects an English or a German Date-form and displays the result accordingly.
Bahá'u'lláh the prophet-founder of the Bahá'í-faith created the calendar of this wonderful religion with 19 months of 19 days each. He synchronised this calendar with the sun by inserting 4 days (or 5 in leap years) immediately at the beginning of the month of the fast.
(The number 19 has a symbolical value to the Bahá'ís because the Arabic word 'unity' has a numerical value of 19 and the Bahá'í-faith is known to be the Religion of 'unity' because the unity of the whole mankind, the unity of the religions and the unity of the races are the main teachings).
- Comment and Uncomment are variations of the source code of the Blockcomment FKey from Symantec. It serves to mark text in Pascal source code as comments to the compiler.
- Phone Call was just the first FKey to check my invoking function. Its cute and you can fool somebody at your phone with a call on the other line. I don't remember the author of this FKey but it was free.
- Special Key is written by Andrew Welch and it inserts 4 Chicago symbols for command key and some others .
In the future I will provide more FKeys to use with CopyPaste.
EVENTTYPE
If you enter the edit window either by command + 'C' + mouse or by command + 'V' + mouse, the default eventtype will be noevent, that means after leaving the window nothing happens. In this menu you can choose to paste the current clipboard or to copy to the currently selected clipboard. typing the V or the C again chooses the appropriate eventtype.
ABOUT THE AUTHOR
My name is Peter Hoerster and I started programming for one reason: I wanted to have the date of any day expressed in the calendar of the Bahá'í faith. As I started with this simple task, I liked programming so much that I tried more. Now I am ready to show you an INIT for every day use and of course it includes my first algorithm as an Bahá'í-date FKey extension. I am also working on a program which allows to retrieve specialy formatted ASCII Text. I have many of the holy scriptures of the world religions as ASCII-files and I wanted to get all the informations I need in a fast way. This program will make an index of the chapters and will allow a complex search through all the books. As modern life is complicated, it is interesting to know what answers the religions of the world can give to the main problems of the mankind.
If you like the CopyPaste, give it to your friends and to anybody interested. But please include this readme (as a German, it took me a real effort to write it in English) If you decide to keep it, please pay the fee in cash. Send it to
Peter Hoerster
Besselweg 243
48149 Münster
Germany
Fax +49 251 980 1663
e-mail: hoerste@uni-muenster.de
KNOWN BUGS AND FEATURES
Some applications like music programs as 'Alchemy' don't write their private scrap to the desk, so that their scrap is not available to other programs and by this CopyPaste can not get its hands on their scrap. (Not my bug)
In some programs the ctrl-key will not work as it should. Some of them are HyperCard, Quark, Ragtime, THINK C. You should reconfigure the Hotkeys for the Tag and Drop in the preferences to solve this problem.
The items in the edit-menu of Word 5.1 are not highlighted correctly in the Bill_Gates_Modus. (Not my bug) It is their bug and so I called this modus as mentioned. The menu-support looks whether it finds the standard edit-commands in the edit-menu of an application and then it installs the sub-menus. If it cannot find the commands (like in Word 5.1 although you see them?!?!?) it looks for the edit names in the edit-menu. So it looks for the English items "Cut, Copy, Paste" and for the German items "Ausschneiden, Kopieren, Einfügen, Einsetzen". If it cannot find any of this names, it gives up. Solution for other languages is: Register and send me your special menu-names and you get a custom version.
Multipaste does not work correctly in THINK Pascal. No time to fix it now.
Editing the default clipboard in Word 5.1 does not work always, because I avoid unnecessary clipboard-converting with the default clipboard to keep it as fast as possible. So use a numbered clipboard for any editing.
HISTORY
Version 1.0
•was a pre-release that used the normal clipboard and made copies of it to disk. This was not compatible with WordPerfect and it was slow. I had to patch two traps.
Version 2.0
•now only uses ram
• only patches one trap
•edit window feature added
•FKey extension feature added
•no window redraw with the paste command
•Bug fixed
Version 2.1
•new internal structure
•faster
•smaller
•In previous versions if you copied anything to a numbered clipboard or if you pasted anything from a numbered clipboard, the next 'normal' paste (no number) brought the clipboard-content of the last numbered clipboard you have used. This proved to be not very handy and was removed with the benefit of having 7 clipboards with almost the same behaviour. Number '0' is the default one which you will use without an additional number.
• menu 'Swap' was added
• menu ' EventType' was added
• new About-screen
•less bugs - safer hex
• Some programs process their eventloop not exactly as Apple prescribed it. With these programs you found the numbered clipboards not working.
Version 2.2
• One user of the Netherlands wanted to paste more than one clipboard in a paste sequence. CopyPaste no allows to type up to six numbers after the 'command V' sequence and the six clipboards are pasted in the desired order. In the moment doubles are not realised. If you haven't released the command key and type the 'V' again, the paste-sequence is cleared.
• In the Edit menu of the edit window you find the 'Store' and 'Restore' feature added, which allows to store the current clipboard directly into CopyPaste without prompting for a filename. It works like a 'one page scrapbook'. This will change the CopyPaste file itself. So don't worry if CopyPaste grows bigger when you store much data.
• Now works with DAs because the internal structure and the trap to patch was changed.
• Removed a bug that causes a crash when an installed FKey invoked the same trap that CopyPaste patches. Now the reentrance of the trap is possible.
• Fixed a missbehaviour when invoking the edit window unnecessary redraw happened.
• Fixed a missbehaviour when commenting a Sentence in the default clipboard from the Edit window, which prevents the content from being pasted even if that eventtype was chosen.-
• Fixed the missbehaviour in some programs, that an event (Copy or Paste) was missed and the default clipboard was unintentionaly used instead.
• Fixed a problem with Ragtime, which sometime eats an event without reaction.
• Extended Bahá'í-Date FKey which now detects whether an English or a German date-form is required.
• Fixed an incompatibility with Nisus. Now works with Nisus 3.06 Demo Version. This was the only Version I could test CopyPaste with.
Version 2.3
• MacWrite uses a command-shift-v and a command-shift-c combination. This did not work with version 2.2. The problem is fixed now.
• In the edit window the menus now work as they should! programmers folk, the tip came from the Usenet. You have to write a menuhook and to send a mouseup event if the mouse enters the next menu.
• Three preferences have been added under the apple in the edit window
• CopyPaste now fully supports the standard edit-menu with three sub-menus. Paste-sub-menu shows the kind of scrap or in the case of a text-scrap it shows 15 characters of its content as a quick remainder.
• The Bill_Gates_Modus forces sub-menus in Microsoft-products like Word 5.1 although the items are not highlighted correctly. It also forces sub-menus in other applications that do not use the standard Menudefproc like WordPerfect, Canvas etc. Currently this modus requires an English or a German program. Send money and I'll send you a Spanish Menu-support. Nevertheless in standard-menus everything is fine with or without the Bill_Gates_Modus. If this modus isn't checked, you'll find the sub-menus under the Apple directly under the About-item of the program.
• Tag and Drop is the poor mans drag and drop and if its active, it works as follows: mark (tag, highlight) anything in any program, press the command & ctrl keys and click the mouse at a different position. The highlighted portion will be copied and pasted at the mouse-position. Try it, its really smart. Word 5.x has implemented this nice feature as the more sophisticated "Drag and Drop". You may want to deactivate this function in programs like Ragtime or HyperCard, where the ctrl-key is used.
• MenuSupport toggles the sub-menu-support of CopyPaste. Perhaps you don't like the sub-menus, although you can see 15 characters of a text-scrap in the paste-sub-menu. This is a quick remainder.
Version 2.3.1
• a bug which prevents the Mac to recognise new (not formatted) floppy-disks was removed. I apologise for this bug.
Version 2.3.2
• an incompatibility with Symantecs THINK C editor which sometimes brought up the CopyPaste menus instead of the Think menu was removed.
• the hot key for the tag and drop feature now is just the ctrl-key, the command-key is not necessary
• in the edit window you can now choose the displayed clipboard by typing the appropriate number.
• in the edit window you can choose the eventtype by typing 'x', 'c' or 'v'. Note typing the x means no event!
Version 2.4
• removed a bug, which was introduced in 2.3.2 when using the paste-sequence in Microsoft Word 5.1.
• added an aplication-switcher. The only real good feature of the Windows Program Manager, which allows to switch between open applications by using the command key-tab combination. This has nothing to do with the clipboards, but its nice to use. Thanks to Raimund Jakobsmeyer for the library which is the "workhorse" of this feature.
• In the Tag and Drop feature you can now replace the target where you clicked on by pressing the ctrl and the shift key when you click the mouse. This is done by simulating a double-click on the target.
• A user from Berlin wanted to have the Tag and Drop feature between different Documents. I did my very best to realise this. In Microsoft Word it works fine. It also works with the ctrl-shift-mouse-click.
Version 2.4.1
• The Application-Switcher now uses Color-Icons on a Color-Mac
• The Application-Switcher now searches through different volume-desktop-databases to find the correct Icon
• A new preferences menu-point has been added in the Edit-Window. You can now turn of the Application-Switcher.
• A user from Düsseldorf wanted to use the number-keys on the keypad additionally - voilá. (Still in the range 1 to 6)
• The English textes are hopefully been improved by the help of a spelling-checker. If the world would but speak German.
Version 2.4.2
• The ApplicationSwitcher now uses Color-Icons on 4 Bit Machines (LC I)
• The ApplicationSwitcher now is configurable (either ctrl-tab or cmd-tab)
• The ApplicationSwitcher now brings process information if you hold the hot key and type an "i".
I have to thank the "C-Wizard" Raimund Jakobsmeyer from MacSoftware Design for these improvements to the ApplicationSwitcher.
• The Menus now display the information •Sound• when a sound is in one of the clipboards
• The Menus now display the information •Movie• when a Movie is in one of the clipboards
• The edit-window now playes the sound
• CopyPaste now has 10 clipboards
• a new preferences dialog is introduced
• Tag and Drop now is konfigurable (either ctrl+mouse or ctrl+cmd+mouse)
• Now a German readme file is provided together with the English one
Version 2.4.3
This was a developing version as a step to 2.5. it was send only to some registered users.
Version 2.5
• Now each submenu shows the clipboard-content.
• The textportion in the submenus now has 30 characters.
• many minor bugfixings.
• CopyPaste now allows to restore the clipboards at system-booting. This can be toggled in the preferences.
• The Store and Restore feature in the EditWindow has been replaced with the possibility of opening or saving text or pictures.
• The ApplicationSwitcher now starts with a list of running applications and you can step through them by mouse or arrow-keys. Using the tab-key again brings the old form of stepping through the running applications. You select the process to come in front either by doubleclick or by selecting it from the list and releasing the commandkey.
• The EditWindow is now world-script compatible, i.e. Japanese people can see their textscraps in Kanji.
From the beginning of time the light of unity
hath shed its divine radiance upon the world,
and the greatest means for the promotion of that unity
is for the peoples of the world to understand
one another's writing and speech.
In former Epistles We have enjoined upon the Trustees
of the House of Justice either to choose one language
from among those now existing or to adopt a new one,
and in like manner to select a common script,
both of which should be taught in all the schools of the world.
Thus will the earth be regarded as one country and one home.
The most glorious fruit of the tree of knowledge
is this exalted word: Of one tree are all ye the fruit,
and of one bough the leaves. Let not man glory in this
that he loveth his country, let him rather glory in this
